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1.0 Introduction 



08/A4- is an «bbr«vi«tion for Operating Systc«n/Adv«nc«d. Its purpose 
is to givs its usar an advanced tgpa of coneiand control over the 
software systeeis in the Atari personal computer. OS/Ah- replaces the 
Atari eienu driven DOS coMMnd processor with a less restrictive 
coMsand line processor. The OS/A-t- user types command words and 
parameters rather then invoking menu functions and responding to 
(Questions. The OS/A+ command set is easy to learn since most of the 
commands are the same as the functions desiredi such as RENAME or 
DIRECTORY. The 08/A* command processor allows for user written 
commands as well as the "batch" execution of commands from a file. 
OS/A-t- replaces ONLY the MENU command processor of ATARI DOS. The 
Atari File Manager and Atari 08 are used by OS/A-*- without modifi- 
cation. This means that disk volumes and associated disk files 
are fully interchangable between Atari DOS and OS/A-*>. The only 
known incompatibility is that OSS BASIC A+ SAVE files are not 
compatable with ATARI BASIC SAVE files. ATARI BASIC ATASCII source 
(LIST. ENTER) files will run without modification under OSS 
BASIC A*. The DOS. SYS file on the OS/A* disk is the Atari FMS 
(written by OSS) and Q3/A*, OS/A* disks do not have or need to 
have DUP. SYS or MEM. SAV. 

2. Running OS/ A* 

The 08/A-«- Command Processor is Invoked in the same manner as the Atari 
menu command processor. When the OS/A* disk is bootedi OS/A-*- is 
immediatly entered. If the computer has a cartridge that works with 
the diski such as BASIC, thea the cartridge can be entered via the 
OS/A* CARtridge comfliand. Re-entry of OS/A* from the cartridge is done 
in the same way as it is to Atari DOS. The BASIC command for this 
is DOS. Some cartridges do not allow DOS type exits and thus OS/A-»- 
cannot be used with these cartridges. 

When 08/A* is entered it will clear the screen and display: 

088 08/A-i- ATARI version 1.0 
Copyright (c) 1981 088 

Dl: <cursor> 

The Dl: is the comeiand prompt. It serves two purposes. First it 
tells the user it is ready to accept a command. Secondly, it is a 
reminder of the default disk drive. The default drive, in this 
case, being the faeiil«r file spec for drive 1. 
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3.0- D«f«ult Driv* «n«l Fil« 8p«c«: 



Most OS/A-*> coMMndm and par«a«t«r« deal with files of one sort or 
anothor. Th« Atari Operating Systam roquirvs filas ba spacifiad with 
a filaspac of tha for«: 

<davica>: <optional-f ila-na«a> 

Tha davica for disk filas is of tha form Dn: wharo n"l«2<3<4. For 
aiaaipla# Dl: is tha davica nana of tha disk driva with tho switch at 
tha VT of tha driva sat for driva ona. Othor typos of davicts ara: 
Printar"P:* Cassatta>"C: i 8craan«S: • ate. Tha op t i ona 1-fi la-name is 
usad for naaad fila accessing devices such as the disk units. To work 
wi^h the disk file TEST. ORG on disk drive number I. the operating 
system requires that the file spec Dl: TEST. ORG be used. Having to 
always specify the Dl: c«n be tedious, especially if most of the user's 
fila work is on a single drive. 

The OS/A* system is designe.d to prefix all filenames appearing in a 
OS/A-*- command line with the default driva - if a device has not been 
eiplictly specified. In tha case of D1:TEST. OROi tha user could enter 
only TEST. ORO for a file name and allow 0S/A4> to prefix it with the 
default drive. Thus TEST. ORO becomes Dl: TEST. ORO in the OS/A> 
system. If TEST. ORO happened to be on drive two and the default 
drive was driva one* the user could enter D2: TEST. ORO. OS/A-t- would 
see that tha user has explicitily specified a <devicc> and would thus 
not append the default drive device to that fila name. 

If the user needs to work a great deal with files on drive twoi he can 
change tha default drive so as to avoid the now necessary D2: prefix 
typing. Where the system prompts Dl:<cursor>. the user can respond 
with D2:<return> to change the default drive to the D2: device. The 
next 08/A* prompt line will show D2:<cursor>. Now files accessed on 
drive one will require the explict Dl: prefix typing, while files on 
drive will not require prefix typing. Only devices of the form Dn: 
(where n « 0-9) ara allowed as default drives. OS/A-*- does not check to 
insure that tha new default driva actually exists. The user's first 
indication of an invalid default drive will occur when OS/A-t- attempts to 
access a file on the invalid device (via user command). The error 
message "INVALID DEVICE" will indicate the situation. The user should, 
then set the default device to a valid disk unit. The default device 
change command is ona of tha many OS/A**- commands. 
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4. 08/ A-** CoMHindt 



O^/A-*- ii«s thr«» 8«n«r«l c or groups of coauiiands. Tho c !«•«•« are jk. 
intrintic coauMndSf OKtrinsic coflMn«nds« and axocuto coaunands. 
Intrinsic coiMMnds «r« sxscutsd by usans of rssidsnt codo in tho QS/A+ 
Monitor. Extrinsic comnands ara axacutad by maans of loading and 
running |irogra«s. Tha exacuta subsat of commands provida for tha batch 
axacution of 08/A+ commands from a fila. 



4. 1 Intrinsic CoaMsands: 



Tha intrinsic commands ara axacutad via coda in tha OS/A* monitor. 
Thasa commands do not raquira tha loading of program* to parform thair 
functions. Tha following is a summary of tha OS/A* intrinsic commands: 



DIRECTORY - List Diractory 

PROTECT - Protact a fila (from changa or arasa) 

UNPROTECT - Unprotact a fila 

ERASE - Erasa (dalata) a fila 

RENAME - Ranamas a fila 

LOAD " Load a binary fila 

SAVE - Sava « binary fila 

RIM - Exacuta a program at soma addrass 

CARTRIDGE - Run Atari cartridga in tha A cartridga 



slot 



Tha dafault driva changa command Dn: is also an intrinsic command. All 
intrinsic commands may ba abraviatad with tha first thraa characters. 
As a matter of fact< OS/A* only looks at the first three characters while 
testing for an intrinsic command. Each of the commands will be covered 
in detail later in this manual; however* to give you a feel of the 
intrinsic commands let's look at the DIRECTORY command. While looking 
at thasa txamplast assume the Dl: is the dafault device and has been 
placed on tha screen by 08/ A-*-. 

Di: DIRECTORY list entire directory of disk on drive one 

Dl: DIRECT " " " - m 

Dl: DIRTY " " " 

Dl : DIR " " " m u H u m 

D1:DIR ♦. ♦ " " I* u » t, M 

U N M H « « M 

M N « H « M « 

Dl DIR D2: list antire directory of disk on drive two 

D1:DIR D2:*. • " " " 

D1:DIR •.OBJ list all files with extension .OBJ on drive one 

D1:DIR D2:*. ASM list all files with extension .ASM on drive two 



D1:DIR Dl: 
Dl:DIR Dl:a. ♦ 
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4. 1. 1 PROTECT 



The PROtcct cooHiiand it used to protect disk filas from being modified 
or ERAsed. Filet that have an asteritk to the left of the file name in 
the directory listing are protected files. 

PROtect file spec 

4. 1. 2 UNPROTECT 

The specified files (PROtected or not> are unprotected. The 
unprotected files can now be modified or ERAsed. 

UNProtect filespec 

4. 1. 3 ERASE 

The specified files are removed from the disk and the disk sectors 
occupied by the files become free to be used again by other files. 

ERAse filespec 

4. 1. 4 RENAME 

Rename a file or files. 

REName old-f i lespec new-filename 

REName old-f i lespec> new-f i lename 
The old-filespec specifies the file(s> that are to be renamed to 
new-filename. Either blanks or a comma may be used to separate 
the filenames. WARNING! Be careful using wild card renames. You 
can get more than one file with the same name and never be able to 
access the second same-named file. (See Appendix B) 

4. 1. 9 SAVE 

The SAVE command is used to write (copy) a section of RAM to a disk 
file. The area of RAM to be written is given as the two hexidecimal 
parameters start address (sa> and end address (ea). 

SAVe filespec sa ea 

Example: 

SAV TEST. OBJ 4000 4FFF 

The sa and ea parameters are separated by blanks or a comma. The 
ea must be greater than or equal to sa. 

QS/A* will write a six byte header to the file before writing the data. 
This header consists of the binary file indicator* the sai and the ea. 

Binary File Indicator (2 Bytes) «FFFF 

sa (2 Bytes) least significant byte first («(X>40) 

ea (2 Bytes) least singificant byte first (»FF4F) 

data (ea - sa) 1 bytes 

The saved file may be later loaded with the LOAD command. 
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4. 1. 6 LOAD COMMAND 



Th« Load command is used to load binarg files into RAM. The 
specified file is checked for the Binary File Indicator («FFFF 
as the first two file bytes). If the indicator is present the 
next four bytes are assumed as the sa and ea of the data. OS/A-»- 
will then copy the next ea-sa 1 bytes of data from the file to 
RAM starting at mm. OS/A* will also place sa in the OS/A* RUNLOC 
cell. If OS/A+ does not recieve an end-of-file after loading the data 
it will assume another code segment is present. Each following code 
segment is like the first except that the •FFFF header is not present. 
Q3/A* will only place the sa from the first segment in RUNLOC. 

LOAD filespec 

OS/A+ also supports the Atari load and go scheme. If the load file 
has the proper INIT and RUN vectors* OS/A-*- will perform the INIT 
and RUN functions (see Atari DOS 2.0 manual for details). 

The OSS assembler (EASMD.COM) creates object files that are load- 
able fs LOAD files. 

4. 1. 7 RUN COMMAND 

The Run command causes OS/A-t- to call (JSR) a routine in RAM. 

RUN optional-hex-address 

If the optional hex adress is specified then QS/A-»- will place 
the given hex adress in the OS/A-*- RUNLOC and then call the routine 
via the address in RUNLOC. If the hex address is not specified 
then OS/A* will call the address that is currently in RUNLOC. 
The address in RUNLOC may have been set by a previous LOAD or 
RUN command or via the execution of an extrinsic command. 

4. 1. 8 CARTRIDGE 

The parameterless CARtridge command causes OS/A* to transfer control 
to the CARTRIDGE in the A cartridge slot. There are two ways OS/A* 
will call a cartridge* either with a warm start or a with a cold 
start. The cartridge cold start tells the cartridge to reinitialize 
its memory and start cold. The warm start tells the cartridge to 
retain its memory as it was upon exit (via DOS command or RESET). 
The first OS/A* cartridge call will always be a cold start. Sub- 
setiuent OS/A* calls will be warm starts unless OS/A* has executed a 
memory changing command. Memory - chang ing commands are LOAD and 
extrensic commands. 

4. 1. 8. 1 RESET 

If a cartridge has control and the RESET key is pressed* OS/A-»- will 

be entered. If it is desired to re-enter the cartridge* simply 
enter the CAR coeMiand. 
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4.2 Extrinsic CoMMnds: 



Th« sxtrinsic coMMnds ar« programs that ars run by OS/A-t-. Any program 
file of ths load file format and containing tha .COM extension may be 
used as a 08/A-»- extrinsic command. The QS/A* COPY command is one such 
extrinsic command. If you DIR the OS/A-*- diskettet you will see a file 
named C0PY.COM . The program in the C0PY.COM file is what is executed 
when the COPY command is entered. Assuming that Dl: is the default 
device* the COPY command would look like: 

Dl:COPY <from-f ile-name> <to-f ile-name> 

or " 

DlrCOPY TEST. OBJ D2: TEST. OBJ 

to copy TEST. OBJ from drive one to drive two. 

Whenever any command is given to OS/A-t- it first compares the command 
entered (first three characters only) to its intrinsic command list. 
If the command is not in the intrinsic list< it is assumed to be 
extrinsic. OS/A* will process the extrinsic command by: 

1) Prefix the command with the default device (if a device 
is not specified). 

2) Attach the .COM extension to the command. 

3) Open the generated file spec for input. 

4) Test file for proper Load file format (see 4.1.6). 

5) Load and execute the program. 

The COPY command illustrated will execute only if the file COPY. COM 
exists on drive one and is of the Load file format. If any element of 
the procedure fails various error messages will result. Step 1 of 
the procedure implies that a device may be specified. If the default 
device is drive two and the C0PY.COM program is on drive onei our 
example COPY would look like: 

D2: Dl : COPY Dl : TEST. OBJ TEST. OBJ 

which again copies TEST. OBJ from device one to device two. Never 
explictly specify the .COM extension as part of the command. The 
command C0PY.COM will result in a file spec of Dl : COPY. COM. COMi 
which is invalid. If the file is not of the proper formati the error 
message ADR RANGE ERROR will most likely appear. 

The extrinsic command class contains an infinite number of commands. 
Some extrinsic comoiands (such as COPY) are supplied by OSS. Most 
extrinsic commands are user written. If you are intrested in writing 
your own extrinsic commands* see Appendix B. 



-6- 



4.3 Batch Procatfting: 

Th« OS/A+ axacuta faatur* allows the user to axccuta ona or many OS/A+ 
commands with a singla command. Lat's supposa that you wrote a set of 
BASIC programs that must ba run in sequence. You could issue the OS/A-*- 
extrinsic BASIC command (execute BASIC. CQIDi then from BASIC run each 
program ona at a time. If the running time of the BASIC programs was 
very long you could sit at the key board for hours just to type RUN 
program-name every once in awhile. OS/ A* allows you to create and 
execute an EXECUTE file which contains one or many OS/A-t* commands. 
You would then enter one command that would free you from the keyboard 
for more important (or fun) things. 

4.3.1 Executing EXECUTE files: 

Any text file with the filename extension . EXC can be used as a OS/A-t- 
execute file. The execution of the file is invoked much like the 
extrinsic commands* except the command is proceeded with an AT "8" 
symbol. To execute the EXECUTE file DEMO. EXC on the Dl: default device 



Dl: tDEMO 



OS/A-t- will build the file spec Dl: DEMO. EXC and read that file line by 
line executing the 0S/A4- commands just as if they were being entered 
from the keyboard. 

Humans are not quite perfect in the eyes of computers and sometimes 
make mistakes. QS/A* commands specified in error will generate error 
messages. If OS/A-t- discovers an error while executing an EXECUTE file< 
it will print the error message as usual and STOP executing the EXECUTE 
file. 

Execution of an exexute file will also stop after the CARTRIDGE command 
is executed. 

4.3.2 Execute File Format 



An execute file is simply a text file. Each line of the text file 
will become a OS/A-t- command when executed. The three basic rules 
of text file LINES arc that: 

1) they must contain valid OS/A-t- commands< 

2) they must be less than 60 characters in length 

3) they must end in a carriage return (ATASCII »9B). 

OS/A-t- allows the commands in an execute file to be proceeded by numbers 
and blanks. This feature allows the command lines to be numbered 
for readability and thus document their purposes. 
The execute file line: 

LOAD OBJ. TEST <return> 
and the line: 

100 LOAD OBJ. TEST <return> 
are the same to OS/A-t- . OS/A-t- scans the line for the first non- 
numericli non-blank character before starting to scan the command 
word. The EDITOR of the OSS EASMD program can be used to create 
and modify execute files. 
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4. 3. 3 Execute Intrinsic Commands 



OS/A-t- has four special intrinsic commands dssignsd for use with 
csscuta files. These commands are: 

REMARK Remark or comment (does nothing) 

SCREEN Allows execute commands to echo to the 

screen. This is the default mode. 
NOSCREEN Turn off Echo of execute file command lines 

to the screen. 

END Stop executing the execute file and return 

OS/A-*> to keyboard entry mode. 



4. 3. 3. 1 REMARK 



The REMARK command provides a means of commenting and documenting 
an execute file. OS/A-4- will ignore all characters on the REMARK 
command line and proceed to the next command file line. The command 
file: 

100 REM BACKUP DAILY TRANSACTION FILE 

110 BASIC TFBACKUP.BAS 

120 REM PRINT TRANSACTION REPORTS 

130 BASIC TREPORTS. BAS 

140 END 

uses OSS BASIC A+ to work with some transaction BASIC programs. The 
REMARK statements explain the process. LINE 110 will load and execute 
the OSS BASIC A-<> (BASIC.COM on default drive) which will in turn 
run the TFBACKUP.BAS BASIC A-«- program (SAVED on default drive). 



4. 3. 3. 2 SCREEN/NOSCREEN 



OS/A-*- normally echos the command lines to the screen so that it 
appears as if they were typed in as keyboard commands. The 
NOSCREEN command can be used to prevent the echo process. After 
NOSCREEN has been executed^ no further EXECUTE file command will 
appear on the screen until: 

1) the SCREEN command is executed or 

2) the EXECUTE file stops for some reason. 

4.3.3.3 END 

The END command provides a documentable END to the execution of 

of an execute file. It may also be used to stop the file's execution 

before the actual end-of-file. 
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4. 3. 4 PROeRAM CONTROLLED EXECUTE FILE STOP 



It i« soMtimas desirable for a program in « chain of exacuting 
progr««s to stop the oxocuto procoss. The usual rsason for 
this is that the program has dctsctsd an error scvsro enough to in 
validate the processes performed by the following program(s). 
The continued execution of the execute files is provided for 
bv a single byte flag within OS/A-»-. If a program sets this 
byte to zero« then upon returning to OS/A+ via DOS or CP * 
(BASIC statements) the execute file execution will immediately sto 
The execute flag is located 11 bytes from the start of QS/A*. 
The address of OS/A+ is pointed to by memory location 10 («0A}. 
The fallowing BASIC A+ program segment will turn off the execute 
file and return to OS/A*. 

1000 CPAOR - DPEEK(IO) 

1010 EXCFLG «> CPAOR 11 

1020 POKE EXCFLG. 

1030 DOS 



4. 3. 5 STARTUP. EXC 



The execute filename STARTUP. EXC has special meaning in the OS/A-*- 
system. When the system is first booted (power up)« OS/A-*- will 
search the directory of the booted disk volume for a file named 
STARTUP. EXC. If STARTUP. EXC is on the booted volume. OS/A+ 
will execute that file before requesting keyboard commands. 



5.0 SYSTEM INTERFACE GUIDE 

The Mritsr of asssAbly language coda will most likaly need to 
interface with the Atari Operating System (OS). If the 
asse«Rbly code is to become an extrensic command, there may 
be a need to interface to OS/A+ . The Atari OS manual provides 
a proliferation of information about the Atari Operating System 
which will not be covered here. 



5. I 8YSEQU. ASM 

Every OS/A+ master disk contains an assembler source file. SYSEQU. ASM. 
that has various commonly used Atari OS and OS/A+ system equates. This 
file may be included in an assembly languae program via the OSS 
EASMD include function (.INCLUDE #D1: SYSEQU. ASM) 

5. 2 OS/A+ MEMORY LOCATION 

OS/A-f- is designed to be placed just after the Atari File Manager. 
Since the acatual location of OS/A+ may vary with different versions 
of a file manager, a fi«ed location has been assigned to point to 
OS/A+. The location (CPALOC-»OA) is the same one Atari uses to point 
to DUP. All Atari programs that use a DOS exit vector through tOA. 

5.3 EXECUTE PARAMETERS 

The OS/A+ execute flag is located CPEXFL (»0B) from the start of OS/A+. 
The CPALOC may be used as an indirect pointer to access the execute 
flag. 

LDY tCPEXFL i GET DISPL TO FLAG 

LDA (CPALOC). Y .LOAD FLAG 

The Execute Flag has four bits that control the execute process: 



EXCYES tSO 
EXCSCR »40 
EXCNEU »10 



EXCSUP »20 



If one. 
If one. 
If one. 



If one. 



an execute is in progress 

do not echo execute input to screen 

a new execute is starting. Tells 

OS/A+ to start with first line of the 

file 

a cold start execute is starting. 
Used to avoid file-not-found error 
if STARTUP. EXC is not on boot disk. 



OS/A+ performs the execute function by opening the file. POINTing to 
the next line, reading the next line. NOTE the new next line and 
closing the file. To perform these functions. OS/A+ must save the 
execute file name and the three byte NOTE values. The filename 
is saved at CPEXFN (»0C) into OS/A+. The three NOTE volues are saved 
at CPEXNPOIC) into OS/A+. (CPEXNP+0»ICAUX5i CPEXNP+l«ICAUX4i 
CPEXNP+2-ICAUX3). By changing the various execute control para- 
meters, a programmer can cause recursion and/or changing of ex- 
ecute files. 



5.4 DEFAULT DRIVE 

The OS/A+ default drive file spec is located at CPDFDV (♦07) into 
OS/A*. The Default Drive here is ATASCII Dn: where 'n' is the ATASCII 
default drive number. 
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3. 9 EXTRINSIC PARAMETERS 



Th« sxtrinsic co«ai«ndc Miy b» callsd with paramctsrs typed on the 
coflifliand line. The OSS coouMnd 

Dl -.COPY FROMFILE D2: TOFILE 

is «n ffxaffpla of this. Th» antire paramster line is saved in 
the OS/A-»- input buffer located at CPCtlDB (»40> bytes into OS/A+ 
and is available to the user. Since most command parameters are 
file na«es< as/A+ provides a means of extracting these parameters 
as filenames. The routine that performs this service begins at 
CPGNFN («03> bytes into OS/A-»- . The routine will get the next 
parameter and move it to the filename buffer at CPFNAM («21) bytes 
in OS/A-»-. If the parameter does not contain a device prefixi then 
OS/A-t- will prefix the parameter with the default drive prefix. 
The first time COPY calls CPONFN the file spec "Dl : FROMFILE" is 
placed at CPFNAM. The second time COPY calls CPGNFN the file spec 
"D2: TOFILE" is placed in CPFNAM. If CPGNFN were to be called again 
then the default filcspec would be set into CPFNAM at each call. 
To detect the end of parameter condition< the user may check the 
CPBUFP (tOA into OS/A-*-) cell. If CPBUFP does not change after a 
CPGNFN call then there are no more parameters. The filename buffer 
is always padded to 16 bytes with ATASCII EOL («9B) characters. 
The following example sets up a vector for calling the get-filename 
routine. 

CLC 

LOA CPALOC 
AOC ftCPGNFN 
STA GETFN+1 
LDA CPALOC-fl 
ADC ttO 
STA GETFN+2 



GETFN JMP O 
The following routine then gets the next file name to CPFNAM. 



LDY 


•CPBUFP 




iSAVE CPBUFP 


LDA 


<CPALOC>. 


Y 


i VALUE 


PHA 








JSR 


GETFN 




iGET NEXT FILE FARM 


LDY 


•CPBUFP 






PLA 






J TEST FOR NO NEXT 


CMP 


(CPALOC). 


Y 


i FARM 


BEQ 


NONEXT 




iBR IF NO NEXTPARM 


LDY 


•CPFNAM 




J ELSE GET FILE 


LDA 


(CPALOC). 


Y 


J NAME FROM BUFFER 



iADD CPGNFN 

iTO CPALOC VALUE 

{AND PLACE IN 

{ADDRESS FIELD 

J OF JUMP 

i INSTRUCTION 



9.6 RUNLCX: 



The OS/A+ RUNLOC i*3D into OS/A-*-) is used as th« OS/A+ vector to 
routines with tho RUN> LOAD and oxtrinsic commands. An application 
that allows exits to OS/A-*> can change RUNLOC to provide a warmstart 
re-entry to the application (if the user enters RUN with no para- 
Imeters). If the application is not reusable and wishes to forbid 
re-entry* the high order byte of RUNLOC («3E into OS/A-*-) should be 
set to zero. 

LDY »RUNL0C+1 i FORBID RE-ENTRY 

LDA »0 ;T0 ME 

STA (CPALOO.Y 



5. 7 EXITS 

OS/A-)- calls all programs (except cartridges) via the 6502 JSR 
instruction. A called OS/A+ program may return back to OS/A-*- 

via the RTS instruction or via a vHIP (CPALOC). If the 
JMP (CPALOC) is used. OS/A-«- will close lOCB zero and re-open 
it to the E: device (which clears the screen). Either the 
JMP (CPALOC) or the RTS return will cause OS/ A* close lOCBs 
one through seven. 
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APPENDIX A 
OSS EXTRINSIC Ci3l111ANDS 



A-l. COPY 

COPY froi»-f il«-sp«c to-fil«-«p«c 

The copy cofflm«nd will copy on« fils< th« f rom-f ilc-spaci to the 
to-fil*-«poc. COPY doof NOT allow a chango of diskettes while 
copying: both source and destination must be Mounted when the 
COPY coflueand pauses after loading. 



A-2. INIT 

XNIT (no parameters) 

The INIT command is used to: 

1) FORMAT A DISK <0R) 

2) FORMAT A DISK AND WRITE DOS. SYS (OR) 

3) WRITE DOS. SYS 

INIT is menu driven and will give you the oportunity to change 
disks before executing. DOS. SYS is the OS/A-»- boot loader and is 
required to make the OS/A* boot from the disk. 

A-3. DUPDSK 

DUPDSK (no parameters) 

DUPDSK is used to duplicate an entire disk. It can be used with a 
single drive. It will format the destination disk for you if 
you choose to do so. When you are finished with DUPDSK* you 
must insert a system disk (a disk with DOS. SYS) because DUPDSK 
will (purposefully) re-boot the system. 
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APPENDIX B 
FHS PORES 



Thsrc «r« ««v«r«l 'pokes' that c«n bm done to tho Atari FMS that 
coflias with OS/A-)-. Thasa pokas ara used to change certain FliS 
paraaatars. The changes can be made permanent by using INIT 
to write (re-write> DOS. SYS after the poke is done. 



B. 1 NUMBER OF FILE BUFFERS 

The FMS allocates space for file buffers. One file buffer is 
required for each open disk file. The number of file buffers 
allocated is the number of files that can be open at the same 
time. The OS/A-*- system is shipped with three (3> file buffers 
allocated. Three is the recommended minimum. The nul). can 
be changed by poking a new value at ^709 (decimal 1801). The 
maximum usable value is 7 (any value greater than 7 wastes space). 
The changed value does not go into effect until the system is booted. 
This means that you MUST rewrite (or write) DOS. SYS on the disk 
and than reboot the disk. 



B.2 NUMBER OF DRIVES 



The FMS drive byte is used to tell FMS how many drives you have 
on your system. The FMS is shipped with the drive byte set for 
two drives (Dl: and D2: ). Each drive allocated via this value 
consumes an additional 128 bytes of RAM for a drive buffer. If 
you have more or less than 2 drivcs< you will probably want to change 
this value. This value* like the value for the number of file 
buffersi does not go into effect until the system is booted. 
The drive byte is located at location >70A (decimal 1802). The 
appropriate values are: 

1 drive « »01 (decimal 1) 

2 drives- *03 (decimal 3) 

3 drives* (07 (decimal 7) 

4 drives- »0F (decimal 15) 



B. 3 FAST DISK WRITE 



The Atari disk can be commanded to write sectors with verify or 
without verify. The write WITH verify causes the drive to read each 
sector immediately after writing iti this process assures that data 
on the disk is valid but causes write operations to run about half 
as fast as they could run if the write was done without verify. 
Depending upon your patience* the importance of your data> and your 
objective view of the reliability of your drives and disks* you can 
choose either wr ite-with-ver if y (slow) or wr ite-without-verif y (fast). 
The FMS location to change is %779 (1913 decimal). The write-with- 
verify value is •97 (87 decimal). The write-without-ver if y (default* 
faster write) is «90 (80 decimal). 
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B. 4 RENAME WOES 



If you happen to rmnmmm ««v»ral filas (for •xamplc> uith the us« of 
m wild card ranaaa) in such a way that you and up with two files of 
tha %smm namai you naad to ramembar this section. The problem: after 
ending up with two files of the same name* all further accesses to 
that filename will access only the first file that appears in the 
directory. Even a wildcard rename will not work: both files are again 
renamed to the same name. 

The solution: You may patch FMS to alter the RENAME code. The patch 
causes RENAME to change only the first file in the directory that 
matches the given filespeci not all matching filenames. To make the 
patch/ POKE a lero («00) to location «C2E (decimal 3118). To restore 
RENAME to normal functioning/ poke *BB (decimal 184) to the same 
location. 

CAUTION: because this patch affects ALL renames/ and will not now 
allow multiple RENAMES/ etc./ it is probably not advisable to make 
the patch permanent. 
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